home *** CD-ROM | disk | FTP | other *** search
/ .net (French) 1996 November / .net Magazine (FR) - Issue 01 - Nov 1996.iso / mac / Butineur / Netscape Plug-ins / KM's QuickTime plug / Sources / npapi.p < prev    next >
Text File  |  1996-02-04  |  6KB  |  207 lines
  1. unit npapi;
  2. interface
  3.  
  4. uses Quickdraw, Events, Printing;
  5.  
  6. {
  7. npapi.p.  My personal translation of Netscape's npapi.h file from the New SDK 0.7.
  8. Interface bugs are probably mine, not Netscape's.
  9. Kevin McMurtrie  mcmurtri@wco.com
  10. 2/3/95
  11.  
  12. Original info:
  13.     npapi.h $Revision: 1.56 $
  14.     Netscape client plug-in API spec
  15. }
  16.  
  17.  
  18.  
  19. {
  20.     Version constants
  21.  }
  22.  
  23. const
  24. NP_VERSION_MAJOR = 0;
  25. NP_VERSION_MINOR = 6;
  26.  
  27.  
  28.  
  29. { 
  30.     Basic types
  31.  }
  32.  
  33.  
  34.  
  35. type
  36. charstar = ^packed array [1..1] of char;
  37. arglist = ^packed array [1..1] of charstar;
  38.  
  39. {
  40. PROCEDURE C2PStrProc(aStr: UNIV Ptr);
  41. FUNCTION C2PStr(cString: UNIV Ptr): StringPtr;
  42. PROCEDURE P2CStrProc(aStr: StringPtr);
  43. FUNCTION P2CStr(pString: StringPtr): Ptr;
  44. }
  45.  
  46. NPError = integer;
  47. NPMIMEType = charstar;
  48.  
  49.  
  50. {
  51.     NPP is a plug-in's opaque instance handle
  52.  }
  53.  
  54. NPP = record    {NOW VAR, NOT POINTER}
  55.     pdata: Ptr;                { plug-in private data }
  56.     ndata: Ptr;                { netscape private data }
  57.     end;
  58.  
  59.  
  60.  
  61. NPStream = record    {NOW VAR, NOT POINTER}
  62.     pdata: Ptr;                    { plug-in private data }
  63.     ndata: Ptr;                    { netscape private data }
  64.     url: charstar;                { CONST}
  65.     TheEnd: longint;
  66.     lastmodified: longint;
  67.     end;
  68.  
  69.  
  70. NPByteRange = record
  71.     offset: longint;                { negative offset means from the end }
  72.     length: longint;
  73.     next: ^NPByteRange;
  74.     end;
  75.  
  76.  
  77.  
  78. NPSavedData = record
  79.     len: longint;
  80.     buf: array [0..0] of SignedByte;
  81.     end;
  82. NPSavedDataPtr = ^NPSavedData;
  83.  
  84. NP_Port = record
  85.     port: CGrafPtr;           { Grafport }
  86.     portx: longint;          { how far away the top window corner is from object (neg #s)}
  87.     porty: longint;
  88.     end;
  89.  
  90. NPWindow = record 
  91.     window: ^NP_Port;            { platform specific window handle }
  92.     x: longint;                    { position of top left corner relative to a netscape page }
  93.     y: longint;
  94.     width: longint;                { maximum window size }
  95.     height: longint;
  96.     clipRect: Rect;                { clipping rectangle in port coordinates }
  97.     end;
  98. NPWindowPtr = ^NPWindow;
  99.  
  100.  
  101. NPFullPrint = record
  102.     pluginPrinted: boolean;        { Set TRUE if plugin handled fullscreen printing }
  103.     printOne: boolean;            { TRUE if plugin should print one copy to default printer }
  104.     platformPrint: THPrint;        { Platform-specific printing info }
  105. end;
  106.  
  107. NPEmbedPrint = record
  108.     window: NPWindow;
  109.     platformPrint: THPrint;        { Platform-specific printing info }
  110. end;
  111.  
  112.  
  113. NPPrint = record
  114.     mode: integer;                { NP_FULL or NP_EMBED }
  115.     case integer of
  116.         1: (fullPrint: NPFullPrint;);        { if mode is NP_FULL }
  117.         2: (embedPrint: NPEmbedPrint;);        { if mode is NP_EMBED }
  118. end;
  119.  
  120.  
  121. { Mac-specific structures and definitions.}
  122.  
  123. {
  124.     Non-standard event types that can be passed to HandleEvent
  125.  }
  126. const
  127. getFocusEvent = (osEvt + 16);
  128. loseFocusEvent = (osEvt + 17);
  129. adjustCursorEven = (osEvt + 18);
  130.  
  131. NP_EMBED = 1;
  132. NP_FULL = 2;
  133. NP_BACKGROUND = 3;
  134.  
  135. NP_NORMAL = 1;
  136. NP_SEEK = 2;
  137. NP_ASFILE = 3;
  138.  
  139. {#define NP_MAXREADY (((unsigned)(~0)<<1)>>1)   Huh?!?!?!?}
  140.  
  141.  
  142. {
  143.  *  Error and reason code definitions.
  144.  }
  145.  
  146. NP_NOERR = 0;
  147. NP_EINVAL = 1;
  148. NP_EABORT = 2;
  149.  
  150. NPERR_BASE = 0;
  151. NPERR_NO_ERROR = (NPERR_BASE + 0);
  152. NPERR_GENERIC_ERROR = (NPERR_BASE + 1);
  153. NPERR_INVALID_INSTANCE_ERROR = (NPERR_BASE + 2);
  154. NPERR_INVALID_FUNCTABLE_ERROR = (NPERR_BASE + 3);
  155. NPERR_MODULE_LOAD_FAILED_ERROR = (NPERR_BASE + 4);
  156. NPERR_OUT_OF_MEMORY_ERROR = (NPERR_BASE + 5);
  157. NPERR_INVALID_PLUGIN_ERROR = (NPERR_BASE + 6);
  158. NPERR_INVALID_PLUGIN_DIR_ERROR = (NPERR_BASE + 7);
  159. NPERR_INCOMPATIBLE_VERSION_ERROR = (NPERR_BASE + 8);
  160.  
  161. NPRES_BASE = 0;
  162. NPRES_NETWORK_ERR = (NPRES_BASE + 0);
  163. NPRES_USER_BREAK = (NPRES_BASE + 1);
  164. NPRES_DONE = (NPRES_BASE + 3);
  165.  
  166.  
  167.  
  168. {
  169.     Function prototypes.
  170.     Functions beginning with 'NPP' are functions provided by the plugin that Netscape will call.
  171.     Functions beginning with 'NPN' are functions provided by Netscape that the plugin will call.
  172.  }
  173.  
  174. {
  175. NPError               NPP_Initialize(void);
  176. void                  NPP_Shutdown(void);
  177. NPError     NP_LOADDS NPP_New(NPMIMEType pluginType, NPP instance, uint16 mode, int16 argc, char* argn[], char* argv[], NPSavedData* saved);
  178. NPError     NP_LOADDS NPP_Destroy(NPP instance, NPSavedData** save);
  179. NPError     NP_LOADDS NPP_SetWindow(NPP instance, NPWindow* window);
  180. NPError     NP_LOADDS NPP_NewStream(NPP instance, NPMIMEType type, NPStream* stream, NPBool seekable, uint16* stype);
  181. NPError     NP_LOADDS NPP_DestroyStream(NPP instance, NPStream* stream, NPError reason);
  182. int32       NP_LOADDS NPP_WriteReady(NPP instance, NPStream* stream);
  183. int32       NP_LOADDS NPP_Write(NPP instance, NPStream* stream, int32 offset, int32 len, void* buffer);
  184. void        NP_LOADDS NPP_StreamAsFile(NPP instance, NPStream* stream, const char* fname);
  185. void        NP_LOADDS NPP_Print(NPP instance, NPPrint* platformPrint);
  186. int16                 NPP_HandleEvent(NPP instance, void* event);
  187.  
  188. void        NPN_Version(int* plugin_major, int* plugin_minor, int* netscape_major, int* netscape_minor);
  189. NPError     NPN_GetURL(NPP instance, const char* url, const char* window);
  190. NPError     NPN_PostURL(NPP instance, const char* url, uint32 len, const char* buf, NPBool file);
  191. NPError     NPN_RequestRead(NPStream* stream, NPByteRange* rangeList);
  192. NPError     NPN_NewStream(NPP instance, NPMIMEType type, NPStream* stream);
  193. int32       NPN_Write(NPP instance, NPStream* stream, int32 len, void* buffer);
  194. NPError     NPN_DestroyStream(NPP instance, NPStream* stream, NPError reason);
  195. void        NPN_Status(NPP instance, const char* message);
  196. const char* NPN_UserAgent(NPP instance);
  197. void*       NPN_MemAlloc(uint32 size);
  198. void        NPN_MemFree(void* ptr);
  199. uint32      NPN_MemFlush(uint32 size);
  200. void        NPN_ReloadPlugins(NPBool reloadPages);
  201.  
  202. }
  203.  
  204. implementation
  205. end.
  206.  
  207.